home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1995 October
/
EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso
/
Aminet
/
comm
/
fido
/
ROCK14.lha
/
Rock.DOC
< prev
next >
Wrap
Text File
|
1995-04-18
|
9KB
|
274 lines
**************************************************************************
Rock v1.4 - Fidonet mailer for point systems
Copyright (C) 1995 Jean-Marc Xiume'
This software is distributed under the terms of the
GNU General Public License. Read "license.doc" for more details.
Rock is based upon POP, Copyright (c) 1994 Denis Turcotte
and JAZ Copyright (c) 1994 Robert Williamson
All wpl code except for modifications specific to ROCK,
is copyright (c) 1994 Denis Turcotte and Robert Williamson
Rock.rexx except for modifications specific to ROCK,
is copyright (c) 1994 Robert Williamson
LaunchWPL is copyright (C) 1994 Robert Williamson
xferq.library is copyright (c) 1993 David Jones
and (c) 1994, 1995 Robert Williamson
wpl.library is copyright (c) 1993 Russell McOrmond
**************************************************************************
Introduction
------------
Welcome to Rock, one of the smallest Point mailers available for the
Amiga. It's written using the WPL and Arexx languages.
Rock is based upon POP, the world's smallest mailer, by Denis Turcotte,
and on JAZ v1.01 by Robert Williamson (for the rock.rexx script).
Rock is pretty easy to install and to configure, is not memory and disk
space hungry, and allows to call the all the different phone numbers of
your boss if the line is busy.
For calls to other systems than the boss, it can make use of the nodelist
if you already have installed the traplist.library, otherwise it asks for
the phone number.
To keep things simple, the only available protocols are WAZOO for
negociation and ZEDZAP for file transfer.
An example configuration file (ROCK.cfg) and the related doc (RockCfg.doc)
are given.
Installation
------------
Simply copy the ROCK directory where you want, and assign "rock:" to that
directory. You should add a line like the following one in your
user-startup:
Assign rock: DH1:Fidonet/Rock
The libraries in the distribution's libs directory (wpl.library,
xferq.library, and xprzedzap.library) must be accessible to the system.
You can either copy them in the libs: directory, or add the following
line to your user-startup:
Assign libs: rock:libs add
To properly unarchive files and preserve file attributes you should use
the -a option of LHA, or manualy set the "s" flag of "rock" and "boss"
with the protect command. ( e.g.: protect rock +s )
Before starting to use Rock, you must configure it. Read "RockCfg.doc",
then modify the configuration file "rock.cfg" to suit your needs.
If you want, you can use the Fidonet Nodelist in traplist format. The
traplist software must be installed and the traplist.library must be in
the libs: directory.
Usage
-----
Amigados template: rock ADDRESS,CONFIG
To start a session with your boss, just type "Rock" in the shell, or
click on the BOSS icon (the "s" flag must be set for those files,
see installation).
To call another system, give its 4D address as an argument on the
command line (ex: ROCK 1:167/151.0), Rock will then ask for the phone
number and the password for this system.
If you use the nodelist (see the nodelist parameter in the configuration
file), rock will try to find these datas there. If it cannot find them,
it will ask to enter manually, like above.
You can also give the name of the config file to use as an argument,
for example if you want to poll more than one BBS.
It's a standard amigados template, so if you give a config file name
and no address you have to use the "config" keyword.
Examples:
rock
rock 2:320/104
rock 2:320/109 tlcsbbs.cfg
rock config tlcsbbs.cfg
You can terminate rock by pressing control-c in its window.
Support Scripts
---------------
The "KillRock" script is for... trying to kill Rock if things go wrong.
The Arexx script "WaitRock" waits for rock to terminate. It can be used,
for example, in an amigados script like this:
...
rock:rock ;start rock
wait 3 ;allow it some time to declare its arexx port
rx rock:waitrock.rexx ;wait until the end of the session
...
This scripts accepts as an argument the number of seconds to wait between
each test, in order to optimize the CPU time used.
To start Rock from Spot, use the "StartRock.spot" script from the Arexx
menu in Spot.
Notes
-----
Rock is MailWare. If you like it, please send me a nice postcard of your
country (or if you're too lazy a NetMail will do :-) ). It not only
makes me happy but allows me to register the users for a better support.
Enjoy !... :-)
Comments and suggestions are welcome:
smail: Jean-Marc Xiumé
Parc du Belvédère
83120 Sainte-Maxime
FRANCE
fidonet : 2:320/104.22
amiganet: 39:180/1.22
usenet : jmx@ramses.fdn.org
jmx@ramses.telesys-innov.fr
Thanks to
---------
- All those who created WPL
- Denis Turcotte for the original idea and wpl script
- Robert Williamson for the XferQ management script
- Arnaud Meurgues, Alain Chofardet, and Luc Gibert for beta testing
and improvement ideas.
History
-------
* Rock 1.4 - 19 apr 1995
- corrected invalid copyright notices
- added missing copyright notices
- removed the possibly privatee version of wpl.library v0.99.02 and replaced it
with the public version 0.97.04
- replaced obsolete xprzedzap.library 0.56j with the current version 3.5
- corrected xprsetup command for new xprzedzap.library
* Rock 1.3 - 01 mar 1995
- "waitrock" support script. Waits until rock exits.
* Rock 1.3beta5 - 12 feb 1995
- ** Warning, configuration file modified ! Read the docs !! **
. Parameters grouped in 5 sections (nets,fido,modem,display,files).
. Added the addresses of the boss' different nets (fidonet,
amiganet...).
. Added the initloop and initwait parameters, for modem initialization
purpose.
. Added the minbaud parameter, to hang up the modem if the connexion
speed with the boss is lower than minbaud.
. Changed the names of the display variables.
. Added the closestatus parameter, to choose if the status window will
close itself of not, after rock has exited.
. Added the nodelist parameter. It's the path of the directory where
are the nodelist files.
- It's now possible to use the NodeList ! (traplist format).
- The configuration parameters have now a default value, except of course
those in the FIDO section.
- Suppressed the .FLO part in the "rock" script. This is now done by the
new "bossflo.rexx" script.
- No need to change the "rock" script any more, neither for the boss main
address, nor for the different nets. All is now done in "rock.cfg".
- Changed the modem init phase.
- Automatic creation of the xferq directory ("assignxferq" script)
- Updated the config-file doc, be sure to read it.
- The validity of the given address is now checked before calling, by the
new "addrcheck.rexx" script.
- New "nodelist.rexx" script, to find the node's phone number and password
in the nodelist.
- Corrected a bug in rock.rexx . The .?LO files with a CR as line-end
caracter are now handled correctly.
- New "config" argument to the "rock" script, in order to use the config
file of your choice.
* Rock 1.2c - 30 dec 1994
Unrealeased developpement version.
* Rock 1.2b - 14 dec 1994
- Some minor changes.
* Rock 1.2a - 01 oct 1994
- Rock is now able to open its windows on a given public screen.
* Rock 1.2 - 28 sep 1994
- Amigados launch script "rock" changed in order to concatenate the .FLO
files of the different nets in a single file named with the main address
of the boss. Previously, rock sent only the fidonet files.
- Added the different addresses of the boss in the config file, in order
to have the correct address for each called phone number.
- Added "bossoutbound.rexx" script to rename the .?LO, .?UT and .REQ files
according to the current called boss address. Rock doesn't support AKAs,
and send only the files that match the current address.
- The logfile reports if the given address doesn't match the one we are
connected to.
- Rock.wpl updated according to the above changes.
* Rock 1.1 - 24 sep 1994
- The Rock.rexx script has been corrected, as the previous didn't sent
out the file-attaches (at least in my tests with Trapdoor ;) ).
- Use of the ROCK: assign instead of Mail: for Rock's files.
- The logfile gives more details on what's going on:
. date and time at the beginning of each line.
. start and exit point of the program.
. address ans phone number of the called system.
. reports the reply message from the modem.
. tells if an error has occured or if the session has been manually
aborted.
. after the negociation, gives the name of the called system, the name
of the sysop, and the name of his mailer.
. session connect time (ROCKtime.rexx).
- Various changes in ROCK.wpl.
- KillRock script, just in case ;)
* POP 0.9 *
Original version by Denis Turcotte.